Functions Provided by the Movie Export Component11

This section documents routines provided by the QuickTime Movie Export component. These functions can be used by other data export components to implement their own functionality.

MovieExportNewGetDataAndPropertiesProcs

MovieExportNewGetDataAndPropertiesProcs returns MovieExportGetProperty and MovieExportGetData procedures that can be passed to MovieExportAddDataSource to create a new data source. This function exists in order to provide a standard way of getting data using this protocol out of a movie or track.



 
pascal ComponentResult MovieExportNewGetDataAndPropertiesProcs (MovieExportComponent ci, 

                     OSType trackType, TimeScale *scale, Movie theMovie, Track theTrack, 

                     TimeValue startTime, TimeValue duration, MovieExportGetPropertyUPP 

                     *getPropertyProc, MovieExportGetDataUPP *getDataProc, void **refCon)

ci: Identifies the Movie Toolbox's connection to your component.
trackType: Specifies the format of the data to be generated by the returned getDataProc .
scale: The timescale is returned from this function, and should be passed on to MovieExportAddDataSource with the procedures.
theMovie: Identifies the movie for this operation. This movie identifier is supplied by the Movie Toolbox. Your component may use this identifier to obtain sample data from the movie or to obtain information about the movie.
theTrack: Identifies the track for this operation. This track identifier is supplied by the Movie Toolbox.
startTime: Specifies the starting point of the track or movie segment to be converted. This time value is expressed in the movie's time coordinate system.
duration: Specifies the duration of the track or movie segment to be converted. This duration value is expressed in the movie's time coordinate system.
getPropertyProc: Specifies a callback function that provides information about processing source samples.
getDataProc: Specifies a callback function the export component uses to request sample data.
refCon: Passed to the procedures specified in the getPropertyProc and getDataProc parameters.

DISCUSSION

This function is only implemented by movie data export components. The returned procedures must be disposed by calling MovieExportDisposeGetDataAndPropertiesProc .

RESULT CODES

To be provided

MovieExportDisposeGetDataAndPropertiesProcs

Disposes of the memory associated with the procedures returned by MovieExportNewGetDataAndPropertiesProcs.



 
pascal ComponentResult MovieExportDisposeGetDataAndPropertiesProcs (MovieExportComponent ci, 

                     MovieExportGetPropertyUPP getPropertyProc, MovieExportGetDataUPP 

                     getDataProc, void *refCon)

ci: Identifies the Movie Toolbox's connection to your component.
getPropertyProc: Specifies a callback function that provides information about processing source samples.
getDataProc: Specifies a callback function the export component uses to request sample data.
refCon: Passed to the procedures specified in the getPropertyProc and getDataProc parameters.

RESULT CODES

To be provided